# 从 flask 库中导入 Flask 类，Flask 类是 Flask 框架的核心，用于创建 Flask 应用实例

from flask import Flask
# 创建一个 Flask 应用实例，__name__ 是 Python 中的内置变量，
# 它代表当前模块的名称。Flask 用它来确定应用的根目录，以及静态文件和模板文件的位置
app = Flask(__name__)
# @app.route("/") 是一个装饰器，它将下面定义的函数与指定的 URL 路径绑定起来。
# 这里将路径 "/"（即应用的根路径，对应访问 http://127.0.0.1:5000/ 或 http://localhost:5000/ ）
# 与 index 函数关联，当用户访问该路径时，会执行 index 函数
@app.route("/")
# 定义一个名为 index 的函数，该函数是一个视图函数，用于处理用户对上述绑定路径的请求
def index():
    # 函数返回一个包含 HTML 标签 <h1> 的字符串，这个字符串会作为 HTTP 响应的内容返回给客户端浏览器。
    # 浏览器会将 <h1> 标签内的文本渲染为一级标题，这里显示的内容是“你好”
    return "<h1>你好</h1>"
# if __name__ == "__main__": 是 Python 中的常用条件语句，用于判断当前脚本是否作为主程序直接运行。
# 当脚本作为主程序运行时，__name__ 的值为 "__main__"；当脚本被其他脚本导入时，__name__ 的值是模块名
if __name__ == "__main__":
    # 调用 app.run() 方法启动 Flask 应用的开发服务器。
    # 默认情况下，服务器会在本地地址 127.0.0.1（也就是 localhost）的 5000 端口监听 HTTP 请求。
    # 在开发阶段，使用此方法可以方便地对应用进行测试
    app.run()